RUST-APT

rust-apt provides bindings to libapt-pkg.

Currently there is only basic package querying. The goal is to eventually have all of the functionality that python-apt has.

This is a fork of apt-pkg-native-rs, but is designed to be more intuitive.

A big thanks is in order for FauxFaux. His original crate is a huge contribution to this project. It likely would not have gotten done with out him.

This Crate is Under Active Development

This API is far from what could be considered stable. If you plan on using it in a real project make sure to pin the exact version. Breaking changes will be frequent and potentially unnannouned as the API comes together.

Additionally, if you do anything wrong, libapt-pkg will just segfault.

If you find a way to segfault without using the libapt-pkg bindings directly, please report this as a bug.

Documentation and Examples

For more instructions on how to use rust-apt see our crates.io page.

Getting packages

The cache.packages() method is an iterator of all packages that can be sorted with the PackageSort struct.

Here is how you could iterate over packages that are upgradable. They will also be sorted by name using the .names() method on PackageSort

use rust_apt::cache::{Cache, PackageSort};

let cache = Cache::new();
let sort = PackageSort::default().upgradable().names();

for pkg in cache.packages(&sort) {
	println!(
		"Package: {} {} is upgradable to {}",
		pkg.name,
		pkg.installed().unwrap().version(),
		pkg.candidate().unwrap().version(),
	);
}

License Note

This crate is licensed under the GPLv3 or later.

The original project was under the MIT License. This license has been included in the source code to comply.

At this point barely any of rust-apt code is similar to apt-pkg-native-rs.

Building

libapt-pkg-dev must be installed.

Thread safety

It is not advised to use this crate in multiple threads.

You're free to try it but development will not be focused on making this crate thread safe.